Creates a new file in the specified directory.

OSErr PBCreateFileUnicodeSync (
    FSRefParam *paramBlock
);

paramBlock

A pointer to a parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function.

• ref

  On input, the directory where the file is to be created.

• nameLength

  On input, the number of Unicode characters in the file's name.

• name

  On input, a pointer to the Unicode name of the new file.

• whichInfo

  On input, which catalog info fields to set. This field is optional; you may set it to NULL.

• catInfo

  On input, the values for catalog info fields to set. This field is optional; you may set it to NULL.

• newRef

  On output, a pointer to the FSRef for the new file. This field is optional; you may set it to NULL.

• spec

  On output, a pointer to the FSSpec for the new file. This field is optional; you may set it to NULL.

You may optionally set catalog information for the file using the whichInfo and catalogInfo parameters; this is equivalent to calling FSSetCatalogInfo after creating the file. If possible, you should set the textEncodingHint in the catalogInfo.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)